BCI NET 2/BCI NET 2.iso/archives/programming/arexx/supmacro11upd.lha/SuperMacrosDOCS.FinalWriter

Final Write Document | 1995-01-10 | 94.3 KB | 395 lines

SuperMacros




Final Writer
®
 ARexx
®
 Automation


by
S. R. Giovenella











































©Copyright 1994 S.R.Giovenella, All rights reserved
®Final Writer is a registered trademark of SoftWood, Inc.
®ARexx is a registered trademark of Commode-Amiga, Inc.

Auto_Save
Originally written for Final Copy users, but better that the Final Writer auto
save feature, because it can be totally transparent.  Its also has more
flexible timing options.  Caution:  if you don't use the "Confirmation" option,
there is no way to terminate the routine, except for ending the program and
restarting it.

Quick_Envelope
Entering Data
To begin, simply type the address on the screen, in the font and size you would
like, and highlight it with the mouse.  Then run the SuperMacro by selecting
the "Other >> ARexx Script" option from the "User" menu.  Then go to the
directory that contains the SuperMacros and double-click on
Quick_Envelope
.  Better yet, add the script to a the "User Menu" or the "Button Strip".  If
no text is highlighted, the SuperMacro will ask you for some.  Be sure the font
and size you want is already selected.

You will then be asked to enter a name for the template envelope.  This is the
document that the address will be printed upon.  A sample template named
"Template_BusinessEnvelope" has been supplied, and should be placed in your
FWDocs drawer, so the SuperMacro can find it.  The address will be inserted
after of the text on the "template", so be sure the last line is at the proper
position, and the margins are set correctly for the address.  As long as this
"template" envelope prints correctly, so will the final product.  Note: if this
document is in a drawer with a different name, you will need to edit the macro
itself to reflect the correct document drawer's name.  Always work with a copy
of your original software, as macros are easy to screw up.

Manipulating Data
Once the envelope is created and addressed, the words can be manipulated as
normal text (just cancel the print requestor first).



Create Bar Graph
Entering Data
Before you run this
SuperMacro
, you must enter the data to be graphed.

Entering the data to be graphed is a very simple process.  The
SuperMacro
 will look for each element of the graph in a certain line position.  Just
enter each line of data in the proper order, then hit return.

·

The first line must be the
T
i
tle
 of the graph.
·

The second line must be the
S
u
btitle
.
·

The third line must contain the
X
-axis Title

<tab>

Y
-axis Title
.
·

All remaining lines must contain
X
-axis Data

<tab>

Y
-axi
s Data
.

The following example shows how the data entered on the left, will be used to
automatically create the bar graph shown on the right.  Note the use of the
<tab> key from the third line and onward.

Example:

Our Top Sellers!
Third Quarter 1997
Salesperson

Autos Sold
Sally

15
Mark

12
Jim

18
Steve

11
Nancy

8

Rich

11
Nick

21
Dave

6
Mary

13
Sam

10
Susan

15
John

8



Note:
  The current TextBlock font will be used within the graph.  To change this
font, go to the Graphics/Settings/TextBlocks... menu and select 'Define'.

Selecting Data
The data to be graphed must be highlighted by dragging the pointer through all
of the lines which contain data.  The highlight doesn't have to start at the
very first character, or end at the very last, it just has to overlap each line
that contains data.  Be careful not to highlight lines that contain no data, as
this will prevent the
SuperMacro
 from running properly.


Creating the Graph
Once the data is highlighted, select the
CreateBarGraph
 SuperMacro.  This can be done by selecting the
"Other >> ARexx Script" option from the "User" menu.  Then go to the directory
that contains the SuperMacros and double-click on
Create Bar Graph
.

A requestor will ask you to enter the maximum range for the Y-axis and the
Y-axis increment.  This is the highest number that will appear on the vertical
axis, and the increments which will be plotted on that axis.  In the above
example the maximum range is 25, and the increment is 5.


Manipulating the Graph
Once the graph has been created, it can be moved, sized and rotated just like
any other object.  If you want to change just a piece of the graph, like the
subtitle, you must ungroup the graph first.  Do this by selecting the object,
then choose the "Ungroup" option from the "Graphics" menu.  Now any part of the
graph can be manipulated as an individual object.  To regroup the objects into
one, drag a box around them all, choose "Group" from the "Graphics" menu.

Create_BusinessLetter
No explanation required, just follow the prompts.

Create_Letterhead
No explanation required, just follow the prompts.

Create_Memorandum
No explanation required, just follow the prompts.

Create_Table
Just type in the data using the format:

Title
<return> [Optional]
Item1
<tab>

Item2
<tab>
Item3
<tab>

and so on...
Item1
<tab>

Item2
<tab>
Item3
<tab>

and so on...

Then highlight through all of the data lines you want in the table.  Run the
Macro.

Example:

Farm Animals
Animal

1993

1994
Cows

2

6
Pigs

56

12
Goats

2

6

The above example will produce the following table:


Farm Animals

Animal

1993

1994

Cows

2

6

Pigs

56

12

Goats

2

6

Note: The current margins must go from the Inside to the Outside margin.


Save_Address1.1
Allows the user to input an address and save it to a data file.  The default
data file is called "Address_DataFile" and a sample is provided.  This sample
should be copied into your FWDocs drawer.  The SuperMacro will ask you for nine
pieces of information for each address, then save them all alphabetically
sorted in the data file.  Along with the actual data file, a
copy
 of the data file will be saved with a ".MergeFile" extension.  This is an
ASCII file conforming to the "merge" file format, in case you want to print
merge any or all of this data at a later time.

Note:  So that the .MergeFile can also be used as a print merge data file, it
must
 begin with the field names, such as:

LastName,FirstName,Company,StreetAdd1,StreetAdd2,City,State,ZipCode,Phone


Load_Address1.1
Allows the user to search the data file for any number of matches to a string
of search text.  The address(es) are then inserted at the current cursor
position.

To load all of the addresses in a certain field, such as everyone in the state
of "CO", just add the commas before and after the search text string.  For
example, searching for ",CO," will produce everyone in the state of Colorado,
but not someone named "Cooper".  To load all addresses in the data file, search
for just a comma (",").




SuperMacros





























~
5
 ~